Pagination
Pagination is navigation for paginated content.
Examples
Master component
Examples
Usage
- Refer to the VA Design System for usage guidance
Accessibility considerations
- Refer to the VA Design System for accessibility considerations
- All interactive tappable elements should be coded as links and not as buttons.
- When additional context might be needed, we should apply a11yLabels to the links.
Related
Code usage
A common component for showing pagination on the page. Displays previous arrow, next arrow, and copy message based on current page and item.- Properties
- Example
- Source Code
- Accessibility
Name | Type | Default Value | Required | Description |
---|---|---|---|---|
page | number | Yes | page number | |
totalEntries | number | Yes | total number of items | |
pageSize | number | Yes | pageSize | |
onPrev | () => void | Yes | function to be called when previous is selected | |
onNext | () => void | Yes | function to be called when next is selected | |
tab | string | No | optional tab if screen has tabs for analytics |
How to use the Pagination component
<Pagination page={1} onNext={() => {}} onPrev={() => {}} totalEntries={12} pageSize={10} />
Full code for the Pagination component
import React, { FC } from 'react'
import { useTranslation } from 'react-i18next'
import { Pressable, PressableProps } from 'react-native'
import { Events } from 'constants/analytics'
import { NAMESPACE } from 'constants/namespaces'
import { logAnalyticsEvent } from 'utils/analytics'
import { useTheme } from 'utils/hooks'
import Box, { BoxProps } from './Box'
import TextView from './TextView'
import VAIcon, { VAIconProps } from './VAIcon'
export type PaginationProps = {
/** page number */
page: number
/** total number of items */
totalEntries: number
/** pageSize */
pageSize: number
/** function to be called when previous is selected */
onPrev: () => void
/** function to be called when next is selected */
onNext: () => void
/** optional tab if screen has tabs for analytics */
tab?: string
}
type PaginationArrowProps = {
/** function called when pressed */
onPress: () => void
/** optional accessibility hint */
a11yHint?: string
/** whether or not this button is disabled */
disabled: boolean
/** test id */
testID: string
/** props for icon */
iconProps: VAIconProps
}
export const PaginationArrow: FC<PaginationArrowProps> = ({ onPress, a11yHint, iconProps, testID, disabled }) => {
const theme = useTheme()
const pressableProps: PressableProps = {
onPress: onPress,
accessibilityRole: 'link',
disabled,
accessible: true,
accessibilityHint: a11yHint,
accessibilityState: disabled ? { disabled: true } : {},
}
const boxProps: BoxProps = {
backgroundColor: disabled ? 'buttonSecondaryDisabled' : 'buttonPrimary',
minHeight: theme.dimensions.touchableMinHeight,
p: 15,
borderRadius: 5,
}
return (
<Pressable {...pressableProps} testID={testID} accessibilityLabel={testID}>
<Box {...boxProps}>
<VAIcon fill={theme.colors.icon.pagination} width={16} height={16} preventScaling={true} {...iconProps} />
</Box>
</Pressable>
)
}
/**A common component for showing pagination on the page. Displays previous arrow, next arrow, and copy message based on current page and item. */
const Pagination: FC<PaginationProps> = ({ page, pageSize, totalEntries, onPrev, onNext, tab }) => {
const theme = useTheme()
const { t } = useTranslation(NAMESPACE.COMMON)
const boxProps: BoxProps = {
flexDirection: 'row',
justifyContent: 'space-between',
alignItems: 'center',
width: '100%',
minHeight: theme.dimensions.touchableMinHeight,
}
const onPrevPress = () => {
logAnalyticsEvent(Events.vama_pagination(page, page - 1, tab))
onPrev()
}
const onNextPress = () => {
logAnalyticsEvent(Events.vama_pagination(page, page + 1, tab))
onNext()
}
const previousProps: PaginationArrowProps = {
onPress: onPrevPress,
testID: 'previous-page',
a11yHint: t('pagination.previous'),
iconProps: { name: 'ChevronLeft', fill: theme.colors.icon.pagination },
disabled: page === 1,
}
const nextProps: PaginationArrowProps = {
onPress: onNextPress,
testID: 'next-page',
a11yHint: t('pagination.next'),
iconProps: { name: 'ChevronRight', fill: theme.colors.icon.pagination },
disabled: page * pageSize >= totalEntries,
}
const beginIdx = (page - 1) * pageSize + 1
let endIdx = page * pageSize
// if more than total entries then calculate actual index
if (endIdx > totalEntries) {
endIdx = endIdx - (endIdx - totalEntries)
}
if (totalEntries <= pageSize) {
return <></>
}
return (
<Box {...boxProps}>
<PaginationArrow {...previousProps} />
<TextView flex={1} variant={'MobileBody'} px={theme.dimensions.buttonPadding} textAlign={'center'}>
{t('pagination.info', { beginIdx, endIdx, totalEntries })}
</TextView>
<PaginationArrow {...nextProps} />
</Box>
)
}
export default Pagination